﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="The syntax of the TList command is as follows:"/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>TList Commands</title>

<meta name="MS-HAID" content="TList_71813b71-7e39-4a60-8c79-3d0978efa204.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(133);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/tlist_commands.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="tlist.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="tlist_examples.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugging_resources.htm">Debugging Resources</A> &gt; <A href="extra_tools.htm">Tools Included in Debugging Tools for Windows</A> &gt; <A href="tlist.htm">TList</A> &gt; </div>
	<div id="winchm_template_title">TList Commands</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>The syntax of the TList command is as follows:</p>
<pre class="syntax">
    <b>tlist [/p </b><i>ProcessName</i><b> | </b><i>PID</i><b> | </b><i>Pattern</i><b> | /t | /c | /e | /k | /m [</b><i>Module</i><b>] | /s | /v
</b>
   </pre>
<h2><a id="ddk_tlist_commands_dtools"></a><a id="DDK_TLIST_COMMANDS_DTOOLS"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="_______tlist______"></a><a id="_______TLIST______"></a>       <b>tlist</b>      </dt>
<dd>
<p>Without additional parameters, TList displays all running processes, their process identifiers (PIDs), and the title of the window in which they are running, if any.</p>
</dd>
<dt><a id="________p_______ProcessName______"></a><a id="________p_______processname______"></a><a id="________P_______PROCESSNAME______"></a>       <b>/p</b>       <i>ProcessName</i>      </dt>
<dd>
<p>Displays the process identifier (PID) of the specified process. </p>
<p><i>ProcessName</i> is the name of the process (with or without file name extension), not a pattern. </p>
<p>If the value of <i>ProcessName</i> does not match any running process, TList displays -1. If it matches more than one process name, TList displays only the PID of the first matching process. </p>
</dd>
<dt><a id="_______PID______"></a><a id="_______pid______"></a>       <i>PID</i>      </dt>
<dd>
<p>Displays detailed information about the process specified by the PID. For information about the display, see the "Remarks" section below. To find a process ID, type <b>tlist</b> without additional parameter.</p>
</dd>
<dt><a id="_______Pattern______"></a><a id="_______pattern______"></a><a id="_______PATTERN______"></a>       <i>Pattern</i>      </dt>
<dd>
<p>Displays detailed information about all processes whose names or window titles match the specified pattern. Pattern can be a complete name or a regular expression.</p>
</dd>
<dt><a id="________t______"></a><a id="________T______"></a>       <b>/t</b>      </dt>
<dd>
<p>Displays a task tree in which each process appears as a child of the process that created it.</p>
</dd>
<dt><a id="________c______"></a><a id="________C______"></a>       <b>/c</b>      </dt>
<dd>
<p>Displays the command line that started each process.</p>
</dd>
<dt><a id="________e______"></a><a id="________E______"></a>       <b>/e</b>      </dt>
<dd>
<p>Displays the session identifier for each process.</p>
</dd>
<dt><a id="________k______"></a><a id="________K______"></a>       <b>/k</b>      </dt>
<dd>
<p>Displays the COM components active in each process. </p>
</dd>
<dt><a id="________m_______Module______"></a><a id="________m_______module______"></a><a id="________M_______MODULE______"></a>       <b>/m</b>       <i>Module</i>      </dt>
<dd>
<p>Lists tasks in which the specified DLL or executable module is loaded. Module can be a complete module name or a module name pattern.</p>
</dd>
<dt><a id="________s______"></a><a id="________S______"></a>       <b>/s</b>      </dt>
<dd>
<p>Displays the services that are active in each process.</p>
</dd>
<dt><a id="________v______"></a><a id="________V______"></a>       <b>/v</b>      </dt>
<dd>
<p>Displays details of running processes including the process ID, session ID, window title, command line, and the services running in the process.</p>
</dd>
</dl>
<h3><a id="comments"></a><a id="COMMENTS"></a>Comments</h3>
<p>In its detailed display of a process (<b>tlist </b><i>PID</i> or <b>tlist </b><i>Pattern</i>), TList displays the following information.</p>
<ul>
<li>
<p>Process ID, executable name, friendly name of the program.</p>
</li>
<li>
<p>Current working directory (CWD).</p>
</li>
<li>
<p>The command line that started the process (CmdLine).</p>
</li>
<li>
<p>Current virtual address space values.</p>
</li>
<li>
<p>Number of threads.</p>
</li>
<li>
<p>A list of threads running in the process. For each thread, TList displays the thread ID (TID), the function that the thread is running, the address of the entry point, the address of the last reported error (if any), and the thread state.</p>
</li>
<li>
<p>A list of the modules loaded for the process. For each module, TList displays the version number, attributes, virtual address of the module, and the module name. </p>
</li>
</ul>
<p>When using the <b>/e</b> parameter, valid session identifiers appear in the process list only under the following conditions. Otherwise, the session identifier is zero (0). </p>
<ul>
<li>
<p>On Windows 2000 and Windows Server 2003, at least one user must be connected to a session other than the console session.</p>
</li>
<li>
<p>On Windows XP, Fast User Switching must be enabled and more than one user must be connected to the non-console session.</p>
</li>
<li>
<p>On Windows Vista, where all processes are associated with two Terminal Services sessions by default, at least one user must be connected to the non-console session.</p></li></ul></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
